Skip to content

Add doc on how to upgrade to new semconv#7807

Merged
dmathieu merged 11 commits intoopen-telemetry:mainfrom
jmmcorreia:sem-conv-doc
Mar 9, 2026
Merged

Add doc on how to upgrade to new semconv#7807
dmathieu merged 11 commits intoopen-telemetry:mainfrom
jmmcorreia:sem-conv-doc

Conversation

@jmmcorreia
Copy link
Contributor

Adds a new "Semantic Conventions Upgrade" section to CONTRIBUTING.md that documents the complete process for upgrading to newer semantic conventions releases as requested in issue #7697.

It includes the details regarding:

  • Generating new semconv packages
  • Updating imports across the codebase
  • Updating the opentelemetry-go-contrib linter configuration

Add section on how to upgrade to new semconv version
@linux-foundation-easycla
Copy link

linux-foundation-easycla bot commented Jan 19, 2026

CLA Signed

The committers listed above are authorized under a signed CLA.

  • ✅ login: dmathieu / name: Damien Mathieu (9e2a27d, bc655ea)
  • ✅ login: pellared / name: Robert Pająk (9e2a27d)

@flc1125 flc1125 linked an issue Jan 20, 2026 that may be closed by this pull request
@flc1125
Copy link
Member

flc1125 commented Jan 20, 2026

Please pass the CLA

@flc1125 flc1125 added the blocked:CLA Waiting on CLA to be signed before progress can be made label Jan 20, 2026
@pellared pellared removed the blocked:CLA Waiting on CLA to be signed before progress can be made label Jan 20, 2026
@codecov
Copy link

codecov bot commented Jan 21, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 81.6%. Comparing base (4b025b4) to head (bc655ea).
⚠️ Report is 1 commits behind head on main.

Additional details and impacted files

Impacted file tree graph

@@          Coverage Diff          @@
##            main   #7807   +/-   ##
=====================================
  Coverage   81.6%   81.6%           
=====================================
  Files        304     304           
  Lines      23424   23424           
=====================================
+ Hits       19129   19131    +2     
+ Misses      3908    3905    -3     
- Partials     387     388    +1     

see 4 files with indirect coverage changes

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

- attribute changes now state that migrations have to be performed
based on the OTEL_SEMCONV_STABILITY_OPT_IN env variable, and
issue is used as an example until a complete implementation is in
place
@dmathieu dmathieu added the Skip Changelog PRs that do not require a CHANGELOG.md entry label Jan 21, 2026
@jmmcorreia
Copy link
Contributor Author

@pellared I addressed all the review comments. Does everything look good now?

Copy link
Member

@pellared pellared left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@MrAlias, can you please double-check given you did this recently?

@dmathieu dmathieu merged commit ba2747c into open-telemetry:main Mar 9, 2026
33 checks passed
@pellared pellared added this to the v1.43.0 milestone Mar 12, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Skip Changelog PRs that do not require a CHANGELOG.md entry

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Document process of bumping semconv

4 participants